Skip to content

docs: adding affilaitions api (CM-1042)#3979

Open
ulemons wants to merge 3 commits intomainfrom
docs/affiliations-api
Open

docs: adding affilaitions api (CM-1042)#3979
ulemons wants to merge 3 commits intomainfrom
docs/affiliations-api

Conversation

@ulemons
Copy link
Copy Markdown
Contributor

@ulemons ulemons commented Mar 30, 2026

Note

Low Risk
Documentation-only change adding an OpenAPI contract; no runtime code paths are modified.

Overview
Adds a new OpenAPI 3.1 spec (backend/src/api/public/v1/affiliations/openapi.yaml) documenting the public Affiliations API, including POST /affiliations (bulk lookup with pagination) and GET /affiliations/{githubHandle} (single lookup).

Defines the request/response schemas (Contributor, AffiliationPeriod, BulkAffiliationsResponse) plus standard error responses and bearer API-key security requirements.

Written by Cursor Bugbot for commit d9e3718. This will update automatically on new commits. Configure here.

Signed-off-by: Umberto Sgueglia <usgueglia@contractor.linuxfoundation.org>
@ulemons ulemons self-assigned this Mar 30, 2026
Copilot AI review requested due to automatic review settings March 30, 2026 14:11
@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

Signed-off-by: Umberto Sgueglia <usgueglia@contractor.linuxfoundation.org>
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an OpenAPI specification for the Public v1 “Affiliations” endpoints to document bulk and single-handle contributor affiliation lookups.

Changes:

  • Introduces a new openapi.yaml describing POST /affiliations (bulk lookup with pagination) and GET /affiliations/{githubHandle} (single lookup).
  • Defines request/response schemas and common error responses (400/401/403/404/429) for the Affiliations API.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Signed-off-by: Umberto Sgueglia <usgueglia@contractor.linuxfoundation.org>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants